XPages Extension Library プラグインをテスト実行する手順を紹介します。 テスト実行を行うためには Domino サーバーを開発環境と同じマシンにインストールしておく必要があります。詳細は以下の事前準備手順でご確認ください。 Domino サーバーがない場合は Domino Designer のプレビュー機能も利用できますが、一部機能が制限される場合があるのでご注意ください。 XPages Extension Library 開発環境構築（１）：事前準備 開発環境構築手順に沿って、Eclipse ワークスペースに Extension Library プラグインのソースコードをインポートしておいてください。 XPages Extension Library 開発環境構築（２）：開発環境構築 なお、テスト実行手順については、以下の developerWorks 記事も参考になりますので、あわせてご覧ください。 developerWorks: IBM Lotus Domino 8.5.2 における OSGi バンドルの開発 Domino Debug Plugin のダウンロード Eclipse ワークスペース上のプラグインをテスト実行・デバッグするためには Domino Debug Plugin が必要です。 OpenNTF の XPages SDK for Eclipse RCP プロジェクトの以下のページからダウンロードできます。 http://www.openntf.org/internal/home.nsf/release.xsp?documentId=CBF874E9C4607B4C8625799D00287B8C&action=openDocument 中央の DebugPlugin120207.zip リンクをクリックしてダウンロードしてください。 DebugPlugin120207.zip のダウンロードが完了したらファイルシステム上に展開しておいてください。 Domino Debug Plugin のインストール ダウンロードした Domino Debug Plugin を Eclipse にインストールします。 Eclipse を起動して、Eclipse のメニューから 「Help」→「Install New Software...」 を選択します。 Install ダイアログが表示されたら、右側の「Add...」ボタンをクリックします。 Add Repository ダイアログが開いたら、「Local...」ボタンをクリックします。 あらかじめ展開しておいた DebugPlugin120207.zip の中の updatesite フォルダを選択して「OK」ボタンをクリックします。 Add Repository ダイアログに戻ったら、レポジトリに名前をつけて（ここでは Domino Debug Plugin）、「OK」ボタンをクリックします。 更新サイトに含まれるフィーチャーがリストされるので、Domino OSGi Debug Plugin にチェックをつけて、「Next ＞」ボタンをクリックします。 Install Details 画面が表示されたら内容を確認して「Next ＞」ボタンをクリックします。 ライセンスを確認して「I accept the terms of the license agreement」を選択して「Finish」をクリックします。 署名されていないプラグインをインストールする際の確認ダイアログが表示されるので、「OK」をクリックします。 インストールが開始されます。 インストールが完了すると再起動を促すダイアログが表示されるので、「Restart Now」をクリックして Eclipse を再起動します。 Eclipse が再起動したら、Eclipse のメニューから 「Window」→「Preferences」 を選択してプリファレンスダイアログを表示します。 プリファレンスダイアログで「Domino OSGi Debug Tooling」を選択し、Domino Bin Directory フィールドの右横の「Browse...」ボタンをクリックします。 Domino サーバーのインストールフォルダを選択して「OK」ボタンをクリックします。 ※ もし Domino サーバーをローカルにインストールしておらず、Domino Designer のプレビュー機能を利用する場合は、Notes のインストールフォルダを選択してください。 プリファレンスダイアログに戻ったら、Domino Data Directory フィールドの右横の「Browse...」ボタンをクリックします。 Domino サーバーの Data フォルダを選択して「OK」ボタンをクリックします。 ※ もし Domino サーバーをインストールしておらず、Domino Designer のプレビュー機能を利用する場合は、Notes の Data フォルダを選択してください。 Domino サーバーのインストールフォルダと Data フォルダが正しく指定されていることを確認したら、「OK」ボタンをクリックしてプリファレンスダイアログを閉じます。 Domino サーバーへのテスト実行用プラグインのデプロイ Eclipse ワークスペース上のプラグインを Domino サーバー上でテスト実行できるようにデプロイします。 Domino Debug Plugin を利用すると、プラグインやフィーチャーをビルドして Domino サーバーにデプロイしなくても、ワークスペース上のプラグインモジュールをそのまま Domino サーバー上の OSGi ランタイムにロードすることができます。 Eclipse のメニューから 「Run」→「Run Configurations...」 を選択します。 Run Configurations ダイアログで、「OSGi Framework」を右クリックして「New」を選択します。 以下を設定して「Run」ボタンをクリックします。
設定の確認ダイアログが表示され、先にプリファレンスで設定した Domino のインストールフォルダと Data フォルダのパスが表示されるので、設定が正しいことを確認して「OK」ボタンをクリックします。 ※ Domino Designer のプレビュー機能を利用する場合は、先のプリファレンスで Notes のインストールフォルダと Data フォルダを指定してあるはずなので、その設定が表示されます。 Success ダイアログが表示されたら「OK」ボタンをクリックします。 ※ ダイアログに表示されているように、プラグインをロードするための設定ファイルが ＜Domino の Data フォルダ＞\domino\workspace フォルダの pde.launch.ini というファイルに出力されます。 プラグインのテスト実行準備が整ったので、Domino サーバーを起動します。 すでに起動している場合は、Domino サーバーのコンソールで以下のコマンドを実行してDomino サーバーの HTTP タスクを再起動します。 （もしくは Domino サーバーを再起動でも可） restart task http 設定が成功していると下図のようなメッセージが Domino サーバーのコンソールに表示されます。 プラグインが OSGi ランタイムにロードされているかどうかを確認するには、Domino サーバーのコンソールで以下のコマンドを実行します。 tell http osgi ss com.ibm.xsp.extlib 下図のように Extension Library のプラグインがリストされればテスト実行成功です。 ※ Domino Designer のプレビュー機能を利用している場合は、Domino Designer を再起動した後、XPage のプレビューを一度実行してください。 これにより、Domino Designer の持つ XPage プレビュー用サーバーが起動されます。 （Domino Designer を起動しただけでなく、必ずプレビューを一度実行してください） Domino Designerへのテスト実行用プラグインのデプロイ サーバーでの動作を確認するだけの場合は Domino サーバーにテスト実行用プラグインをデプロイするだけで十分ですが、Domino Designer 上での表示確認や新しいコントロールの追加などによる再ビルドが必要な場合などには、Domino Designer 上にもテスト実行用のプラグインをデプロイする必要があります。 ここでは、ワークスペースからプラグインをエクスポートして、Domino Designer にロードさせる手順を紹介します。 ※ デフォルトで Notes および Domino Designer は、セキュリティの観点から、フィーチャーのないプラグインだけのモジュールをコピーしただけではロードされない設定になっています。 ここではこの設定を一時的に変更して、プラグインをコピーしただけでロードされるようにします。 セキュリティの制約を緩める設定ですので、開発環境だけでの使用にとどめ、実運用環境では使用しないようにしてください。 まず、Extension Library モジュールの中に含まれている ExtLib-Notes85.zip を展開します。 ※ IBM Notes/Domino 9.0 以降用の Extension Library モジュールにはこの ZIP ファイルが含まれていません。 その場合は、最新の 8.5.x 用の Extension Library モジュールをダウンロードして、その中にある ExtLib-Notes85.zip モジュールを利用してください。 展開したフォルダの中にある framework フォルダを、＜Notes のインストールフォルダ＞\framework フォルダに上書きコピーします。 上書き後、以下を確認してください。
確認できたら、extlib.link ファイルをテキストエディタで開き、path プロパティの値が先ほど確認した extlib フォルダのパス（＜Notesのインストールフォルダ＞/framework/extlib）になるように編集して保存します。
※ パスの表記方法に注意してください。デバイス名の「:」が「\」（バックスラッシュ）でエスケープされており、フォルダの区切り文字は「/」（スラッシュ）です。
これで、Extension Library プラグインをエクスポートするフォルダができました。 次に、このフォルダにコピーしたプラグインを Notes および Domino Designer がロードするように設定を変更します。 ＜Notes の Data フォルダ＞\workspace\.config\org.eclipse.update フォルダの platform.xml をテキストエディタで開きます。 ※ 元の platform.xml ファイルのバックアップをとっておくことをおすすめします。テスト実行完了後に元の状態に戻しやすくなります。 以下の部分を修正して platform.xml を保存します。
以上でプラグインをロードする設定が完了しました。 あとは Eclipse ワークスペース上のプラグインを、先に作った framework\extlib フォルダにエクスポートします。 Eclipse のメニューから、「File」→「Export...」 を選択します。 Export ダイアログで、「Plug-in Development」→「Deployable plug-ins and fragments」 を選択して「Next ＞」ボタンをクリックします。 プラグインの選択画面で、「Select All」ボタンをクリックしてワークスペース上のすべてのプラグインにチェックをつけます。 その後、Destination タブで Directory を選択して、先に作成した ＜Notesのインストールフォルダ＞\framework\extlib\eclipse フォルダを指定して「Finish」ボタンをクリックします。 ＜Notesのインストールフォルダ＞\framework\extlib\eclipse フォルダの下に plugins フォルダが作成され、その下にプラグインの JAR ファイルがエクスポートされていることを確認します。 ここまで完了したら Domino Designer を起動します。（すでに起動している場合は再起動します） Domino Designer が起動したら、Domino Designer のメニューから 「ヘルプ」→「IBM Lotus Domino Designer について」 を選択します。 ダイアログが表示されたら、「プラグインの詳細」ボタンをクリックします。 プラグインのリストの中に先ほどエクスポートした Extension Library プラグインがリストされていればテスト実行成功です。 テスト実行後のクリーンアップ テスト実行後、もとの状態に戻すには以下の操作を行ってください。 Domino サーバー Domino Debug Plugin によって作成された ＜Domino の Data フォルダ＞\domino\workspace フォルダ以下の pde.launch.ini ファイルを削除します。 ※ Domino Designer のプレビュー機能を利用した場合は、＜Notes の Data フォルダ＞\domino\workspace フォルダ以下の pde.launch.ini ファイルを削除してください。 Domino Designer テスト実行時に編集した ＜Notes の Data フォルダ＞\workspace\.config\org.eclipse.update フォルダの platform.xml ファイルを、編集前の状態に戻します。 さらに、＜Notesのインストールフォルダ＞\framework\extlib\eclipse フォルダ以下の plugins フォルダを削除します。